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Note on Dn-^Linel Version of this Document 

This fil e also exists in an on-line version with some on-line aids 
built into it. Th'e on-liire version may be found in KDF as 
(Casseres)NL.ISI- 

NLJST' contains links to ( Cass eres ) CONAN , (C asseres)L I Nj(S, and 
(Cass eresi )1NF3RU which describe the content analyzer, the link 
system* and the i nf ocmati on-r.e tr ie val system respectively. These 
files ere also given as hard copy in the User's Guide. 

Tt>e null statament of NL1ST contains some useful names to jump to 

NiLJSTi is designed to be viewed with statement numbers off. The 
branch-only feature may also be useful- 

A «um!b«r -of trails are built into NLIST; they may be entered froci 
SiLateiment. (trai Is et ) . 



This bar d-ccpy version is in KDF as ( Casseres ) NLUG. 
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Keyset .and i VIEW SPEC Codes 



(keysetex) 1 he keyset has four cases called 0, 1, 2, and 3- The 
center anc left-hand buttons on the mouse are used for specifying 
case as fo 11 owsx Case 0, neither button; Case I. certer button; Case 
2. left «butt,on; Case 3, .both buttons. The buttons are held down while 
striking* chords on the keyset. 

C*se contains lower-case letters, comma, period, semicolon, 
questHicn-incTk, -and space. 

C*se I contains upper-case letters, less-tnan. greater- than. 
coioni. backslash, and tab. 

Case 2 contains various punctuation characters for chords l-!5. 
digits froir Oto 9 for chords 16-25, more punctuation for chords 
26-29 , and ALIMODE and carriage-return for chords 30 and 31. 

Case 3 contains. ViEWSPECs and centerdot. 
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Codes for Keyset and VIEWSPECs 



N£)IE = : Details on the effects of the various VIEWSPECs are gi«n in 
the docu&ert tf.IiEWS- 

Keyse t Co des 



O00OJ a A ! L=L-1 

00010 o 8 " L=L + 1 

0001! c C * L=ALL 

00100 d D $ L = ! 

00101 e £ % L relative 

00110 f F £ recreate display 

00111 -9 G * branch-only on 

01000 ft H ( branch- only off 

01001 A I * content-analyzer on 
0J0I0 J J a content-analyzer off 
01011 k X + trail on 

01 100 1 L -trailoff 

01101 ia M * statement numbers on 

OHIO n N / statement numbers off 

01111 o * frozen statements on 



10001 p P frozen statements off 

10001 i 

10010 r 

10011 s 

10100 t 

10101 u 
101 10 » 
10111 « 

1 1 000 x 

1 1001 y 
11010 z. 
1 101 1- . 

11100 _ 

1 1101 i 

11110 2 \ ALT c enterdot 

Hill SP TAB CR ( nothing) 

Capital-Lett e- -VIEWSPECs 

A l — i ndenl iing on 

B " — •■ indenting off 

C i— - r, a ire s on 



p 





frozen statemen 


Q 


1 


T=T-1 


R 


2 


T =T+1 


S 


3 


T=ALL 


T 


4 


T = l 


U 


5 


po i nter s on 


V 


6 


p oi nter s of f 


H 


7 


L=T=ALL 


X 


ft 


L=T = 1 


Y 


9 


b tank lit res on 


Z 


= 


b lank liir.es off 


< 


[ 


{ no thing) 


> 


3 


{ nothing) 


- 


«~ 


( nothing) 
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D — names off 

E i — cilip picture .and show (sec vectors) 

F '— sihoj Picture lorly if it fits (see vectors) 

G ? — display; file as tree structure (see tree) 

H — . cisplayi file as normal text (see tree) 

I — keyword reordering on (see document on 
i n> f or aati on- retrieval system) 

j — keyword reordering off (see document on 
in form at ion- retrieval sy st era ) 

£ ! — display of statement signatures on 

L — display of statement signatures off 
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<VI£WSP£C> Control of VIEWSPECs 

The AIEWiSFECs arz used as parameters to control the way in which 
statieraents aire displayed. 

VIEW5PEC s say De controlled in three ways: during certain commands 
such .as Jump, or Load, with the View Set command, or from the keyset 
in Case 3. .( The v iewspecs may also be set from the keyboard with the 
right— ha: nc and center buttons on the mouse down, i.e. in Case 3 
position;.} 

Daring the Juap. and Load commands (and a few others), there is a 
point where the VIEWSPECs in the upper left-hand corner of the 
display become large and are accessible to change. They may then 
be ch.arged by typing them in from the keyboard or keyset as upper- 
or loswer-case letters. 

The V. iew !Set command (q) may be used to achieve exactly the same 
e/iec t- 

Case 3 may be u se d to set all of the VIEWSPECs that are not 
capital letters* as shown in the table of keyset codes. 

Tttis nay ba done at any time. 

A filter VIEWSPECs have been given in this fashion, it is 
neicessary to hit Cihcrd 00110, Case 3, for "ne* View," before 
the new VIEWSPECs will become effective. 

Relative! Level Control 

Tfte cote "e" causes the subseqtent setting of L to Be interpreted 
r*»latiive to the level cf the first statement in the new display. 

fo-r exairpl>, suppose that a Jump is being made to a third-l^evel 
st atemert. If "e" is given with no subsequent codes for 
control of L. the result is L = 3. If "eh" is given, the resiult 
is: L-4*. if *e3ba" is given, the result is L=5. 

Thus it is possible to get an appropriate setting of L without 
knowing the appropriate absolute value, simply by specifying a 
re lat ive value - 

Six ■3/IEWjSPECs that; are not self-evident are displayed as two lines in 
the m*pe r left-hand corner of the screen. 

The top. liire shows "L " and "T," which appear either as numbers or 
as the word "all." "L" determines how many levels of statements 
ui'll .be displayed (see level), and "T" determines how many lines 
oif eaict statement will be displayed. 



NLS USER'S GUIDE — V1EWSPECS DGC 12/3/68 



EXCEPTION: When an "e" is given to set L as a relative value, 
the area that normally shows t and T shows "R*N" instead. T;he 
"n" appears as a number; thus when "e" is given, "R+0" is 
displayed; if this is followed with a "b." V+ 1 " is displayed. 

litis s-econd line shows four VIEWSPECss g or h for the branch-o^nly 
parameter! en on off Usee branchonly); i or j for content-analyser 
on 'ort off (see analyzer); lc or 1 for trail feature on or off (see 
trails); and u or v f or pointers displayed or not displayed (see 
P joint* er ) . 
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Introduction to Command Descriptions 
NOTES on,; Syntax Equations 

The capita] letters at the beginning of each equation are the 
contnol letters entered from keyboard or keyset to specify the 
Cjsir.tna.nd. 

CA mesars --co.nro.aind accept;- this is done by pressing either of the 
tifo CA keys on the keyboard, or the right-hand button on the 

sense*. 

SguarSe brackets* are used to incicate selections trade with the bug. 
Tihus >tcl imeans that a character is selected, tvl means that a 
visible string is selected, and so forth. If two characters a^re 
to be seiecteJi' they are shown as [ell and [c!2. 

Tof select an entity with the bug, move the mouse untiL the £>ug 
points st any character within the entity, then push CA. An 
-0-" will appear over the character you have pointed to. If 
this is the character you wanted to point to, push £A again and 
the selection is completed. If the " o" is over the wrong 
character, you can press the left-hand mouse fcutton or the 
"backspace" key and start the selection again. 

"L£T"f means any string of characters input from the keyboard o*r 
keyset. 

".NUMBER" means any number entered from the keyboard or keyset- 
Th* s last (/) means "or." 

The dollar sign ($) by itself means "any number of" (from to 
IGOQ) . The construct mS means "any number equal to or greater 
tlaari *m;" it te construct $n means "any number equal to^or less tthan 

n; - tlh€ ctorstruct m$n rceans "any number from m to n." 

The t erra VIEWSPEC in a syntax equation means that VIEWSPECs may be 
set. - 

Fesr example, the syntax equation for the Replace Text command i se e 
r y is R T tcM [c!2 tIT CA. This wans "type ri type t; select 
a character; select a second character; type a string of 
cbjara-cters; do ;a command acce.pt." 
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Delete CsDinnuands 

<dc) Del'.ete iCharacfter 

S»nta*xi D C Ic3< CA 

Sjeraanht ics ' The selected character is deleted, 
(da) <Del;ete !.Wcrd 

S^-ntax^ D' W Iwl- CA 

Ssmanbtics: The selected word is deleted, 
(dv) 2)el ete iVisiale 

S^mtarx.- Dl V Mi CA 

Ssraarut ics - The selected visible string is deleted, 
(di) .Del ete Invisible 

Syjita? x- D I li 1 C A 

SEsaanitics: The selected invisible string is deleted- 
( dt ) Del ete :Text 

Synta xi D T tcl.l fc!2 CA 

Semantics: The selected text string is deleted from cl to c2„ 
(ds> Del ete Statement 

S^ntaexi D. S Is 3 CA 

S*raanit ics - The selected statement is deleted, 
(db) Del ete Branch- 

S*nta<x" D B fi 1 CA 

S^isanit ics : The selected branch (Statement s and all of its 
substructure) is deleted. 

Cdp> Del ete ) flex : 

Syntax D P Is] CA 

S&mariit ics : The selected plex (the branch headed by Statement s« 
plus -.all other branches uhich are in the same sublist) is deleted 
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(dg> Del etc Group 

Syntax- D G Is] I Is] 2 CA 

Se-iaanit ics = Statements si and s2 roust be in the same sub list- Jihe 
sdeclted group (the branches headed by Statements sJ and s2» and 
all i.nteriven its* branches) is deleted. 

<dd) iDei ete Drawing 

Syntax- D D Is 3 1 CA 

Seasamt ics = Tha drawing associated with the selected statement is 
didlet ec. 
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Insert Cjoiimaards 

(ic) Uns'crt iCharac.ter 

S^.ntacx: I C Ic J« L I T C A 

S«siamtics= LIT ^is inserted immediately after the select ed 
ctoaract er . 

( iu) 3ns«ert tUord 

Sysntarx.: I H W LIT CA 

Semamtics: LIT lis inserted after the selected word, with a SPACE 
between. 

(iv) Instert : Visible 

Syntax: r V tdi LIT CA 

Sscian'it ics- LIT is insierted after the selected visible* with a 
SRACEI bet wean. 

(it) ans'ert Text 

Syntatxs I T Ic.J. LIT CA 

Semantics: LIT (is inserted after the selected character, with <a 
SPACES between. The action is identical to (ic). 

(ii) Insert Invisible 

Syntax X." I I II I LIT CA 

Se.man'itjcs- LIT is insierted immediately after the selected 
in-v is ib le strin g- 

(is) Insert Statement 

Sy,ntax: I S Is I LEVADJ SPACE LIT CA 

Sesnan.tics: LIT (becomes the text of a new sfcateirert (or set of 
si^telmcnts— see centerdot), following the selected statement. 

(ib) Insert Branch. 

5*aata»*S I B Is] LEVADJ SPACE LIT CA 

Sfisianiticss LIT becomes the text of a new statement (or set of 
statements — see centerdot)« following the. branch headed by the 
seledtcd statement. 
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( ip ) JlnS'ert :P lex 

S^nta^xs I P Is J LEVADJ SPACE LIT CA 

Semanht icsi LIT ibecomes the text of a new statement (or set of 
Sst«t eimcnts — see centerdot), following the selected pi e>x. 

(ig) Ins-, ert Croup 

S^ntarx? I G Is 3 tEVADJ SPACE LIT CA 

Siaman.ticss LIT becomes the text of a new statement ior set of 
s&ateiment s — see centerdot >» following the selected statement- The 
eflfSfec t isi identical to (is). 

(iq) 2ns*ert .QED Brusnch 

S^jntasx- I' Q Is 3 <Y/(not Y)/CA) FILENAME CA 

SEsamtics: Note; that no LEVADJ is possible- 

In. response to the feedback message CONVERT CASE* a Y or CA ' 
means YES; any othie r character means N.D. 

1 If YES, ail characters will be read as iowei — case except 
-. tftoise immediately preceded by a backslash: these will be 
cppei — case and the backslashes will disappear. 

1 If NO, alii letters will be read by NLS as upper-case 
: letters; backslashes will be taken literally. 

The text of the QED file becomes a branch following the 
seliect ed branch, at the same level- Normally, if the QED file 
was not craated from NLS with the odq command, there will be 
solme garbage in the new branch. 
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Replace Cotnimands 

Ire) Rep lace Character 

Sy^taxs R C tc3 LIT CA 

Semantics: The selected character is replaced by LIT. 
(rw) Sep lace' Word « 

Sy;nta<x= R W t a 3 LIT CA 

Sssnamticst The selected word is replaced by LIT. 
(rv) iRep lacel Visible 

Syatatx? RVI/liLITCA 

Serenities: The selected visible string is replaced by LIT. 

(rt ) Rep lace Text < 

Syntax- R T tcJ<l tc]2 LIT CA 

Seoanbtics= The selected text is replaced by LIT. 
(ri) Rep lace Invisible 

Syaita.x: R I til LIT CA 

Semantics: The selected invisible string is replaced by LIT. 
(rs) Rep lace. Statement 

Syntatx: R S Is 3 L IT CA 

Semantics: The text of the selected statement is replaced by L.3T 
(see icent erdot )t. 

(rb) Replace Branch 

Syntax- R 8 Is] LIT CA 

Semantics: The branch defined by the selected statement is 
replaiced by LIT. (see centerdot). 

Irp) Rep la!cci Flex : 

Syntacx^ R P Is 1 LIT CA 

Semantics: The pi ex defined by the selected statement is replaced 
by LlfT (slee centerdot )- 

J2 
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(rg) Sep lace Group 

Sy«ta>xt R G £sl I IslZ LIT CA 

Scmanat ics: Tte .group defined by the selected statements is 
replaced by LIT. (see centerdot). 
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Move Cociraan'ds 

(roc) Uiov.'e Character 

Si'ff>taix» K C.IcM IclZ CA 

Scman.ticsi Chariac ter c2 is moved so that it appears immediately 
aifier. Character cl. 

(inu) Mo vie Word 

S*nta>x:'M W In .1:1 tu!2 CA 

Semantics: Ho'd: u2 is moved so that it appears inmediately after 
Word <ul« iwith spaces land punctuation as they should be- 

(mv) Hovi e Visible 

Sy.nle'x- K V I* 3d Iv32 CA 

SeiEan,tics= Visible v2 is moved so that it appears immediately 
afterJ Visible v!, with spaces and punctuation as they should be. 

(mt ) ttoviS Text 

Syntax- M T Ic3*l tc32 tc3 3 CA 

SeraanVtics: Characters c2 and c3 are the first and last characters 
of a :text string; the string is moved so that it immediately 
folio us c3. 

(mi) Movie :Inv is ible 

Sy>ntatx2 M I Lil I £i 12 CA 

Ssisian.tics : The string i2 is moved to follow il- 
(ms) i1ov=e Statement 

Syntax" M S Is 3 I ts!2 LEVADJ CA 

Semantics: Statement s2 is moved so as to /ollow Statement si, at 
a ,lev:el determined by. the LEV ADJ- 

(mb) Movie Branch 

Syntax: K B Es 3 1 Is3 2 LEVADJ CA 

Semantics- The branch headed by Statement s2 is noved so as to 
fcllotw itt-e branch headed by Statement si. ..at a (level determined by 
the LIE V AD J. 
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(mp) Movie PI ex 

Sy.nta*x2 M P Is 3 J ts 12. LEVADJ CA 

Semanit ics = Tte plex defined by Statement s2 is rnioved sx> as to 
fellow Statement si, at a level determined by the LEVADJ. 

Cm 9) Movie Group 

Siyaatatx: M G €s 3 1 IsU Is 13 LEVADJ CA 

Seiaanitics" The group of branches defined by Statements s2 and s3 
is. noilved iso as to folilow Statement si, at a level determined by- 
tls« UEVAfrJ. 

(id) ^lovre Drawing ' 

Sy«ta*x- K D Ls 11 Isl2 CA 

Semantics 5 The drawing associated with s2 is moved to si. 
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Copy Cojaraanfds 

Ccc) Copjy Character 

Sy^tajxs C C IcO.l ic32 CA 

S«aan.tics= Character c2 is copied immediately after Character cl. 

( cw) £op:y Word 

Sjynta?x: C H £*3:J 1u32 CA 

SasBamties : Uord- w? is copied immediately after Word w1- 
(cv) Copsy (V iis ib 1> 

Syntatxs C V Ivl'l £v32 CA 

Seiaanit ics : Visible v2 is copied imraediat el* after Visible v3- 

Cci> £op ; y Inivisial-e 

Stntatxz C J li 3 i I i 12 CA 

Sstmanit ics = Invisible v2 is copied imraed iately after Invisible »1. 
(ct) Copfy Text 

Syntatxs C I 1=1*1 £c12 tc ] 3 CA 

SisaamticsS Text; from Character c2 to Character c3 is copied 
isasediately after Character cS- 

(cs) LopiY St ate rant 

Synlaxz C S [s)l £s32 LEVADJ CA 

Sejaamtics: Statement s2 is copied immediately after Statement sti 
at a llcvel determined by the tEVADJ. 

(cb) Copjy Branch 

Syntax: C B t> 3 i Isl2 tEVADJ CA 

Seraan,tics = Tha branch determined by Statement s2 is copied 
issiaed iate ly after Statement si, at a level deternined by the 
LEVAD-'J. 

(cp) C9p;y Pi ex 

Sprit* k£ O P ls3i XslZ tEVADJ CA 
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Seasanatics: Ths p lex determined by Statement s2 is copied 
immediately after Statement si. at a level determined by the 
LEVAD J. 

{eg) Copjy Croup 

Syntax: C G £s3 1 Is 12 I si 3 LE VADJ CA 

Saraan'it ics : Tha group determined by Statements s2 and s3 is copied 
immediately aft-er Statement sJ . at a level determined by the 
LOADiJ- 

(cd) Copiy Drawing f 

SFa>ta?x= C £> Is 11 Is 12 CA 

Stssan.tics: The drawing associated with s2 is copied to si. 



I? 
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Break arad Jioin iComroaiYds 

(bs> Breaak StateTiemt 

Synta?x= B S U h LEVADJ CA 

Sft-ioaniticss The statemert is broken after tfce seilcctec s/isibie- The 
LOADIJ adjusts the le.vel of the neu statement made up of the last 
part lof the original statement. 

Cbj) Join Statement 

S^ntatxs B J Is J I £sJ2 CA 

Seoanatics- Tha text of s2 is appended to si, and s2 is deleted. 
1/ s2> J-as a sablist, >t he subiist is moved to follow si. 
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Jump Coiusaan ds 

(jo) Jump tol Crigin 

S*nta<x: J VIEWS PEC CA 

SeisanLtics: Tte display start is positioned to the first statement. 

(ji) -Jump to Identuty 

Sy»tavx= J <l/null) Is] VIEWSPEC CA 

Sainamtics- Tha display start is positioned to the selected 
statement. Note that the I in the command specification may be 
oiaitt?ec. 

( ju) Jum p to Up 

Syntax: J U Is! VIEWSPEC CA 

S^roamtics: T he display start is positioned to the statement of 
which the selacted statement is a substatement . 

{ jd) Jum p to Down 

Syntax: J D Is J VIEWSPEC CA 

Semantics- The display start is positioned to t ne first 
substatement of the selected statement. 

(js> Jump tc: Successor 

SyntaixC J S Is] VIEWSPEC CA 

Seaarntics: T h» display start is positioned to the list successor 
of the se lee tad statement. 

(jp) Jump to Predecessor 

Syjat^xC Ji P Is] VIEWSPEC CA 

S^an.tics^ The display start is positioned to the list predecessor 
of ttue selected statement. 

(jh) Jump tc" Head < 

Syntax; J H £sl VIEWSPEC CA 

SeaariiUcs* Tie display start is positioned to the first statement 
ia the list where the selected statement is found. 

(jt) Jump to Tail 

19 
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SyntacxS J T f>J VIEWSPEC CA 

Semantics: The display start is positioned to the last statement 
in the .list where the selected statement is found. 

{ je > Jura p to End 

Trias ico am and expects a third letter. In each case, tfce command is 
sisnil ar to one of the other Jump commands* except that it 
cojisiidtrs a b~a«.nch instead of a statement- The last statement of 
tbe branch is placed at the top of the display. 

ij£i) Jump to End of Identity 

Syntax : J E U Is! VIEWSPEC CA 

Se raantics: The selected statement determines e branch, and the 
latst statement in that branch is placed at the top of the 
di splay. 

(Jen)- Jump to End of Name 

Syntax: J £ N (Iwl./SPACE LIT CA) VIEWSPEC CA 

Semantics: The selected name determines a statements the 
statement determines a branch, and the last statement in that 
bnancti is a Laced at the top of the display. 

(Jes) Jump to End of Successor 

Syntax: J 5 S I si VIEWSPEC CA 

Semantics: The successor of the selected statement determines a 
branch, and the last statement in that branch is placed at the 
top of the display. 

ije?) Jump to End of Predecessor 

Syntax: J E P IsJ VIEWSPEC CA 

Semantics: The predecessor of the selected statement determines 
a branch, and the last statement in that branch is placed at 
th-e tcp of the display. 

{Jeui* Juiip to End of Up 

Syntax: J E 1U Csl VIEWSPEC CA 

Semantics: The source of the selected statemert determines a 
branch, and the last statement in that branch is placed at the 
top of the display. 
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{jed) Jujip to End' cf rDoun 

Syntax: JED Is] VIEWSPEC CA 

Semantics: The first substatement of the selected statement 
debentures a branch, and the last statement in that branch as 
F»l«aced at the top of the display. 

ijeWi Juffp to End of Head 

Syntax: J E H Isl VIEWSPEC CA 

Semantics: The head of the list containing the selected 
statement determines a branch, and the last statement in that 
brianch is *l«aced at the top of the display. 

{jet) Jump to End of Tail 

Syntax: JET £s3 VIEWSPEC CA 

Semantics: The tail of the list containing the selected 
s t.ateit.ent determines a branch, and the last statement in that 
bnanch is Placed at the top of the display. 

(Jeo>! Juirp to End of Origin 

Syntax: J E VIEWSPEC CA 

Semantics: The last statement in the file is placed at the L op 
of I the displ ay . 

(Jev)i Jurp to End of Vector Label 

Syntax: J E .V Uvl /SPACE LIT CA ) VIEWSPEC CA 

Semantics: This is identical to jen {Jump to End of Name) 
except that *a vector label {see label) is selected instead of a 
wore in text;. The selected label or t>he LIT is used as a name 
aniditre .>nd of the branch determined by the named statement is 
pl«ace<2 at the top of the display. 

{ jb) Juip. p to. Back 

S*-nta>ix: J B CA IVIEMSPEC CA 

Sesan.tics: The display start is positioned to the statement 
i^med lately preceding the selected statement {i.e.. the end of the 
sui>ii;st of thz predecessor), if this statement is a "visible" 
statement, i.e. one uhich may be displayed under the current 
VIEWS PECs. If -it is not, then the last previous "visible" 
st*te!menti is used for. the display start. 
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(jn> Jump to: Kara ; 

Synta-x: J N liul/SPACE LIT CA) VIEWSPEC CA 

Se-manit ics= A statement name is specified by either a 
ucxrd-iselectioi or t a literal entry from the keyboard or keyset- . 
Wihen «the command is executed, the statement with the specified 
name is placed at the top of the display. 

If the specified name does not exist, the command is aborted with 
the m ess age "no such name." If more than one statement with the 
specified, rasa exists, the command is aborted with the message 
"d-iipl-iicat e natiei-" 

(jv) Jump to Vecto'r Label 

S^tsxi J V UvI/SPACE LIT CA > VIEWSPEC CA 

S as an .tics:: A statement name is specified by either a vector-label 
selection (sc? label); cr a literal entry from the keyboard or 
keyset-. iWren t he command is executed, the statement with the 
specified n^me is placed at the top of the display. 

I# the specified name does not exist, the command is aborted with 
the m essaige "10= such name." If more than one statement with trie 
specified name exists, the command is aborted yith the message 
"duplicate name." 

{ jl ) Jump to: tin< 

HfilE: for the correct syntax of a link, see docusent LINKS, 

Ibere ere two cases of this command, depending on whether the link 
refers to a loc-at i on in the current file or in another file (uhich 
must sbe on the RAD). 

Srnta-x (uithn file>s J L III VIEWSPEC CA 

Semantics: The statement defined by the link is placed at the top 
of the display, and the VIEWSPECs given in the link are placed in 
effect, unless they are changed by .tidnual input during the 
commatnd, The new vieu is entered in the next location in the 
intra- file r ing= for details on this see document LINKS. 

S/ntatXitcut of file): J L [I] CA CA 

Sefflan,tics= The statement defined by the link (in the file defined 
bf threlink) is placed at the top of the display, and the 
VIEWSPECs sivzn in the link are placed in effect; they cannot be 
changed by asaiual input during the command- The neu view is 
entered in the next location in the interfile stackz for details 
on this slee document LINKS. 
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(jr) Jump to! Return 
Sy«ta:jc= J R CA : 

S«an.tlcss Whenever a jump within the current file is executed . 
(e ^ 0P t for this ore and ja),. the system keeps track of it. A! 
-ring- is maintained, containing all the views that have been used 
in sequence. This command causes a return to the previous view, 
ns charge, is Bade in >the ring itself. For details on this see 
docuai.er.t LINKS. 

NiME=i Because of a bug, the Jump to End commands will cause 
errontecus; entrires in the ring. 

(ja) Jump to Ahead! 

Syntaix- J< A CA 

Se»ai*tics = Whanever a jump within the current file is ^ c ^ d 
(except for this one and jr). the system keeps track of it. A. 
-ring" is maintained, con tain ing a 1 1 the views -trat have b«c ««d 
in sequence. This command (which can only be Us*d meaningful!* 
after jr has ».en used at least once) causes a move f<J ^ r ^ 
along, the ring; no change is made in the ring itself. For details 
on tlvis slee document LINKS. 

NOTE:: Because of a bug. the Jump to End commands will cause 
erroniecus entries in the ring- 

( jf ) Jump to Fi Iz 

Ejects a third letter to specify jfl. jfr, jfa, jfw. ©r jfc. 

CjiDt Ju»p tofile Link 

MOTES For the correct syntax of a link, see document LINKS. 
Syntax: (intrafile: link) JFL £linkl CA 
Syntax= (rit-erfile link) JFL ttinkl CA CA 

Semantics^ The operation of this command is tte sa.ii* as Juap to 
LiSnk. 

ijfrh. Jump to File Return 

SyTntax- J F <R :{CA/ char acter) CA 
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Semantics: Whenever a file is loaded with Load File or a jiwup 
fr»oa one file to another is executed (except under this command 
an d jf-a). thie system keeps track of it- A stack is maintained, 
comta iming al I the views that have been used in sequence. This 
co>nur,arid causes a move backward along the stack, to the file 
Previously viewed. No new entry is made in the stack. For 
details on t hi s see document LINKS. 

Uh;en the characters J F R have been typed, the system will 
display the name of the file to be jumped to. If any character 
is typed instead of the CA, the system will >gc back one more 
step on tha stack :and display another filename. 

NOTES Unlike the rings maintained by the )f and ja commands 
uit.hin a if i le. this stack will not work as a ring. As a 
rule, amove past either end of the stack will cause the 
aessage ILLEGAL ENTITY and the command will be aborted. 

(JJa) Jump to File Ahead 

Syntax^ J F tA { CA/ character ) CA 

Semantics: Whenever a file is loaded with Load File or a jump 
froji one file ±c another is executed (except under this command 
anld jfr), the system keeps track of it- A stack is maintained, 
containing all the views that have been used in sequence. This 
command (uhi ch cannot be used meaningfully unless j/c has bjsen 
usee at least once) causes a move forward along the stack. No 
ne*w entry is made in the stack. For details on this see 
do cement LINKS. 

Uhen the characters J F A have been typed, the system will 
display tha name of the file to be jumped to. If any character 
is typed instead of the CA, the system will go forward one mare 
step en tha stack and display another filename. 

KDT£: Unlike the rings maintained by the jf and Ja commands 
uithin a ifi le» this stack will usually not work as a ring. 
-, /Is a ruler, a move past either end of the stack will cause 
: the message ILLEGAL ENTITY and the command will toe aborted. 

(jfu) Jump to File Working Copy 

Syntax: JF W CA 

Semantics:: The WORKING COPY file is opened and displayed. The 
vice* will be the same as the last view of the WORKING CDPY 
file- . No r»e w entry is made in the stack. 

NOTE: Please see the discussion of the WORKING COPY file* in 
the documeit* LINKS. 
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IJfzh Juitp to File Current 

Sysniax: J F «C CA 

Semantics: The "current" file is the one currently indicated by 
the poiirter -in the interfile stack. Usually the pointer 
imdicates the file being displayed and this.ccwand is 
Beia ring less- However, when the working copy file is being 
displayed, this comrcand is the means to return to the file 
Previously displayed. No new entry is anade in the -stack. 

MOTE: Plaase see the discussion of the WORKING COPY file, in 
the documents LINKS. 
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Pointer £oi8;fflands 

(pf) iPoijnter Fix 

Sy^it^x- P F Icl< l$3(CHAR> CA 

Sjssan.tics: The pointer name ( up to 3 characters) is attached to 
tfrw* specified character. 

(pl> Poijnter List Sh'ou 

S#ntasx: P L 

Seasanit ics: As soon as the commend is specified, the display is 
rcjpia^ced by a list of all the pointers that have been defined- To 
return to the display, enter a CA. 

tpr) P3ijnter! Felaase. Expects a third letter to specify an entity.. 
The options are asr follows: 

(psra)l FoiJiter Release All 

Syntax: P I ;A CA 

Semantics: All pointers are deleted throughout the text. 
(pirs)J Fiointer Release Statement 

Syntax: PR S Is I CA 

Je'mintics: All pointers in the selected statement are deleted. 
(para): Pointer Release Word 

Syntax: P * W Iwl CA 

Semantics" All pointers in the selected word are deleted. 
(prt)s Pointer Release Text 

Syntax: P * !T 'Celt tc!2 CA 

Semantics: All pointers in the selected text are deleted. 
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(q) View Set iCotnrrards. 

Syntax: Q (a/ .,. ./z/A/ ... /L ) CA 

Semaoticis- The coimmand makes the VIEWSPECs accessible for change, - 
just as tthey are during a Jump command, for example. Ihe lower-c^e 
letters -have the effect that they have from sthe keyset- Tfae capital 
letters haiv<2 the following effects: 

A — undenting <'on 

B — .indenting off 

C — names on 

D — na me s off i 

E — iclip' picture and show (see vectors) 

F — jshow picture only if it fits (see vectors) 

C — »disp lay fi'le as tree structure (see tree) 

H — ldisplay file as .ncrraal text (see treeJ 

I — k eywcrd reordering on (see document on inforaat ion- retrieve 1 
syst e r ni) 

j — k:eyuord reordering off (see document aon information-retrieval 
systesm) 

K — idisplay of: statement signatures on 
L — .display of statement signatures off. 
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Set Command* s 

(sc) Set Charactsip'. 

S#ntatx= S C <C/fL/ 1/R/ B7N/F/S/ U/W) CA [c ] ZA 

S&mar&tics'- Tte selected character becomes upper-case, lower-case, 
etc ^according fto the following codes: 

C ( — capital! 

L \ — : lower-case 

I - — i italic * 

8 ! — rorran 

B — boldface 

U . — no boldface 

F l — fil ickar i ng 

S — solid I no-nf li cker ing) 

U — underline 

U — i no underline 

(su) Set Word 

Syntax* S M tC/L/l/R/8/N/F/S/U/W) CA Evl £A 

Semantics: The selected word becomes upper-case, lower-case, etc. 
accor,idins to ttwe codes given in sc. 

(sv) SeU yisdble 

Syntax: S V iUll/ I/R/ B/N/ F/S/ U/M) CA Iv 3 CA 

Sesnan'it ics- Tn> selected visible becomes upper-case, lower-case. 
etc. 'according to the codes given in sc. 

(s i) Seti Inv isible 

Sy.«ta*x- S I <C/ L/ I /R/ B/N/ F/S/ U/W> CA Lil CA 

Semantics: The selected invisible becomes upper-case, lower-case, 
etc- jaccording to the codes given in sc, 

Css) Set Statement 
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Symlaixz S S tC/.L/ I/R/ B^N/F/S/ U/W) CA Is] CA 

Semantics: Tha selected statement becomes tupper-case, lower-case, 
etc;- ^according to the codes given in sc- 

(st) Set. Text 

Syratatxs S T JC/rL/I/R/8/N/F/S/U/U) CA ttl I £t!2 CA 

Seaanitics: The selected text becomes upper-case, lower-case, etc. 
according to ttoe codes given -in sc. 
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freeze Commiiand-s 

( f s ) 3rre.'. ez e Statetn en t 

S^ntatx: f S Is 3 VIEWSPEC CA 

S«fflantics3 The selected statement is frozen, with the specified 
vi««-i 3t iwill -appear at the top of the screen whenever frozen 
statements ar» ibeing shown. 

(fr) Release Statement 

S^tntaixs E; R Is 3 CA 

Semantics" The selectee statement is unfrozen. The selection anay 
be in; trie frozen area of the display or in the normal .viewing 

area-i 

If a) -ReL ease All 
Syntax xS f. A O I 
Semantics- All -froien statements are unfrozen. 
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Alarm Coinraainds 

( a c > A 1 arm 1 cck Set 

S^rstarxs A C NJM'J CA NUM2 CA NUM3 CA 

Shanties: Umii* -NUM2 , and NUH3 are the hour, minute, and second 
to which ithe aliarm clock is s«t- 

(at> Alarm Timer Set. Same as (ac) but relative to present time. 
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Load Comma nids 

(1) (Loaid rCheckpoiint 

S*ntat.x£ L CA VI'EWSPEC CA 

Seiaan^tics= Tha .'checkpoint file is loaded i:nto NLS and displayed, 
beginning at ttve first statement. 

(If) SLoaid Fi le 

Siyintatxi L F tfi<lenamel CA VIEWSPEC CA 

Semamticss The file specified by the filename is loaded into NLS 
and displayed, -beginning at the first statement. 

A mew entry is made in the interfile stack- which is used by t»he 
Jump ito File Return. Jump to File Ahead, and Jump to File Current 
commarncs. For -details, see document LINKS- 
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Output CommBards 

Lo) iOut'put Checkpoint 

Sy.ntafx^: £A 

Sewanhticss Thj 'working text is written out on the "checkpoint" 4 
file* which is automatically created if necessary- 

(of ) .Out put tfiie 

S^ntaix: F {LIT/null) CA CA 

Semantics: The LIT specifies a filenamet iwthich must be a RAD file; 
if iti is ;an existing RAD file, it must be sequential- Jhe working 
teixt «is wtr it tart out on the specified file- 

TWe system will offer the name of the last file the -working 
eocpyi tas bzefn written on t or if it has inot been written out« 
ttve name of the file it was loaded from- If this i's the 
de. sired filenamet the LIT may be omitted. 

(Ad) Out put iDevire-. Expects a third letter to specify the "device.." 
The opti'.ons are asi follows: 

(tfidqJt Cutout 3efd File 

Syntax: D .Q {LIT/1 f i lename! 1 CA 

Semantics: The LIT- or filename specifies a file- Tte* working 
tetxti is out.p«ut through Pass 4 in QED format. Note that 
lo.uei — case letters will come through as garbage* and that 
directives will be executed. 

I Pass 4 is. automatically, initialized iwith the following 
: direct i/eisi psw=0t ind=o* rtj = o, and hsw = o_ 

The origin should not be on the display when DDQ is 
i executed-' 

(od?l> Output Printer File 

Syntax: ) iP K3_I T7 [fi 1 enamel ) CA 

Semantics: The LIT or filename specifies a file- Ti*e working 
tecxt is output through Pass 4 in printer format. 

ThJis- f:i le naiy then be output to the printer itself by using the 
pr-osram PASS A KLUDGE PRINT from Teletype J in the control room. 

(odd)i Cutj>ut Dufra File 
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S/ntax: Q } ID '(LIT/ £F i LENAME1 ) 

Sc mantles: The FILENAME "8-level" causers output on (punched 
pa per tape. . 

(orif)-i Eutput Fill m file 

Syntax: ODf (LIT / [FI LE NAME 1 ) 

Se'mantics"- A file is 'written in the correct format for 
C Rl I - 1 o— f i It. jp r o ce -s s in g . 



(orah (Output IMCL 

S^ntatx:: M 2$2.(Y/CA OR NOT Y/CA) L IT/I f Ue na me 1 CA 

Seiaa nhtics~ HO. Jsource code from the displayed file is .output La 
th« M 0.L conpilerr, which in turn writes object ( assembly) code an a 
designated file, . 

Two optional choices are offered with this command. 

Whien the Mis typed, the word "reentrant" appears in the 
command feedback Line- If reentrant code is desired, the jsord 
is. accepter} <with a CA or a Y if or "yes"). Any other character 
recuses the word "reentrant* to be rejected and disappear. 

Ne xt the word "temps" appears* referring to generation of 
temporary stonage. If temporary storage is to be generated^ 
the .word is accepted with Y or CA; otherwise it is (rejected 
ui:th any other character. 

Finally a 'i-le- name is requested and entered cither as a 
1 idt era 1 cr by a bug selection. 

(os) Out put SPL 

Syjitarx': S LIT./ [ f i lenamel CA 

SeaanLtics^ SPL isource code from the displayed file is output to 
the S.PL compiler, which in turn writes object (assembly) code on 
the desisnated <file. 

(ot ) But put Meta 

S ynt ai x* 0, T LI T./ [ f i le nam e 1 C A 
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Scraaniticss Tree Hcta source code from the displayed file is output 
to the Tree Mat fa compileri which in turn writes object ( assemis&y ) 
code join t:he d>siignatcd file. 
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Execute Commands 

(ec) fxe;ct'te Conte<nt Analyzer 

Far a discussion of the content analyzer, see the document on the 
analyJzer. This, command is also used for tfrve trail feature: see 
trai l;s- 

Syntaixi E C Ip3 CA 

SamariU ics: P is. a pattern uhich specifies a content requirement 
for, statements to be displayed. The pattern is compiled to 
produce a conLemt-analyzer program which will cause only the 
sUt&ments meating the requirement to appear on the display. 

N Bits' This command does not put the content analyzer into action; 
ii merely causes a pattern to be compiled- If the pattern has 
betn tir.correct l*y specified, the message "syntax error* will 
appear; otherwise, the message "successful compilation" will 
a pp ea -r . 

Td pu't »the content analyzer into effect, use the VIEWS.PEC "i '1 to 
L&m it off user the VIEWSPEC "J". See VlfcWSPEC. 

(eoV Execute OOPS 

S-ysstafx- E! CA i 

Sssansticss This command is for experimental use- It is'a way of 
deliberately making MLS blow up on you. 

Whenever ian OOPSS occurs (naturally or on command), a system file 
is automatically written which contains useful information for 
sestet m pr ©gramm er s. 

(ef) £xe;cute Fi 1> Cl'eanup 

S^r.tarx: f F CA; 

Setaan&t ics : Tt i s will, clean out certain invisible problems in a 
filz sand produce a display of messages showing what kinds of 
cnrorjs have been found. 

IK.PDRiTANTi -NQTE--S File Cleanup does not always correct all the 
erarorts it- firdst. 

(es) Execute Statu«s 

Sa^ntaix" € S CAl 
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Saaanitics- As soon as the S Is typed, the display shows various 
ii^msa of iir,f ormat i on about the file- When the CA is hit, the 
nartia; I idispla/ :i s restored. 

(ev) £xe cute Vieuc:hange 

fjOIE". The syntaoc -and semantics are given i.n a separate .section^ 
bocau'is* o,f thjlsr complexity. 
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Vector -Ctoamiands 

{ v J fectior P ac kage J 

Sari5taix" : V Is 1 C A \ 

Semantics- The specified statement is placed at the top of the 
screen and the rest of the screen is cLear^sd- The commands in the 
vectoir paickags imay thien be used to create >or modify a spicture 
attaclihed ito tie: statement. See vectors. 
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Keyword Comimands 

(ks) feyiMjortf. Sel»cit - 

Syntatx- K S U h CA 

Saraantitics: tou>:n the statement is selected** the name is displayed 
to the ,riight ofi the command feedback line- When the CA is h ii» 
t**e name becomes a keyword for use in the keyword system (see 
keywords} . 

(kw) Key word' ,V,e igh'.t 

Sy«ta:x= K W Is I S(NUMBER) CA 

Sewan'atics: Wien the statement is selected, the Wight of its tnaoie 
(as ai key.wcrd) -is displayed to the right of the command feedback 
line. When njmbers are typed in, they change this weight, and 
when «tre CA is hit the number displayed becomes the new weight of 
the k:eyuord (see keywords). If the CA is frit without typing any 
digits « the w*i!gh:t is unchanged. 

Ikf) 3Cey word Forge t 

Sy-ntaix": K F Izl. CA 

Semantics: When the statement is selected, the weight of its name 
las ai keyiword) is set to zero (see keywords). 

tka)' JCeriwcrd ForseJt All « 

Synta? x: K HH 

Semantics:: T^e weights of all keywords are set to zera {see 
k eyio:rds ) . 

(ke) Xey word Execute 

Syntarxx K E C* i 

Semantics:: The keyword system is placed in operation to produce 
an orjdcred list of referents (see document on 
i nf on mist i on-ratsr ievalal system). 
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imousebui* Mous e Buttion s 

Right— Ha:nd Buttoi t 

Wfr*en pushed and, released without any intervening input, tnis 
but tom gives a iCAi (command accept). 

Hners .it is heldi down while a LIT is entered from keyboard or 
keyset* this button causes the LIT to be interpreted as a 
reference to a {pointer. 

Centear Button 

W*>en pushed and released without any intervening inputs this 
button igi.ves a CD! Ccommand delete). 

Wfcen *lt is held- down while a LIT is entered from keyset, this 
buttom causes the LIT. to be interpreted as Case i input. 

Left-^anld Button 

When -pushed and released without any intervening input, this 
bottom gives a {backspace, cau.sing the last input character to be 
thrau'n away. 

When lit is held down while a LIT is entered from keyset, this 
bottom causes the LIT- to be interpreted as Case 2 input. 

Left-iianSd and Center Buttons Together ; 

Hften pushed and released without any intervening input, this 
cMfri.natirorgltf.es a backspace-fcord. causing the last input word to 
be theroyn aaa/.: 

When <it is held, down while a LIT is entered from keyset, this 
com h natron causes the LIT to be interpreted as Case 3 input. 
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I vectored J Me Vecto~ rPa'ckage 

The vector packager allows the user to create simple line drawings* 
with lab;els„ as a ; P art of his file- See v f^r how to enter the 
vectsm P-ackalge i-i (association with a particular statement. 

There-, will eventually be a means to output the pictures, but for 
nan t hey are on.iy visible within NLS„ 

The billowing commands are valid within the vector package: 
Inser t Co remands 

*iv) Insert lVe'ctor 

Syntax- I V (CA / B / CD) CA 
. The bug mark is used to determine the endpoints >of lines. 
Each CA after the first determines a line- 
Thus 4 CAi*s produce 3 lines, with lime 1 meeting .line 2 ^t 
: the position of the second bug mark* and line 2 -meeting line 
3 at th> ithird bug mark. 

, To "lift lyour pencil" and break the continuity of the limes 
type a "B " or a CD. 

(i 15 Insert iLabe 1 

. Syntax- I L SPA'CE LIT CA CA 

Semantics*: After typing the label, hit a CA to attach the 
label to the bug- The next CA fixes the label in its current 
position «on the screen (rounded off to the nearest position 
that can be output on the printer). 

Move Commands 

{hi v) Move /etc tor 

Syntax:: M V INUMBER / nothing) CA <A / B) CA 

; Semantics.: The vectors are numbered if or identification. 

After a vector has been specified by typing its number or 
accepting, the number offered in the mame register, hit a CA. 

. Tihis wills cause the ends of the vector to he marfce d "A" and 
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". Hype the letter of the end you wish 1 o move. That lettesr 
• .wilt bereplaced by an "X" and the either letter iwi 11 go 

- away." 

; Jhe;n position the bug where you .want the end to «o and hit a 
. CA. 

(nTH Hove Lafbe 1 

: Syntax" M L 111- CA CA 

5e i&a nt irsrs When the first CA Is hit* the label IS 1 is 
attached to the bug and moves with It. The next CA fixes 
; the lab> It in the new position. 

tm'd) Hove Or.'aw i ng ! 

Syntax: M D IpointU [point 12 CA 

Semantics': The two points selected define a translation < 
vector; the entire drawing is moved according to this 
? vector, 

Dslztfe Commardsc 

(dv) Delete Vector 

1 Syntax^ £ V CNUKBER / nothing-.) CA 

Semantics'5 Selerct the vector to be deleted, using its 
: number, and hit a CA™ 

Id'U Delet? itabel : 

Syntax^ D L 1 13 CA 

Semantics!: The label 111 is deleted- 
iddl Deleta -Drawing 

Syntax" D D CA 

; Semantics.: All rvectors and all labels in the drawing are 

deleted. . The command is used for starting over from 
■ scratch. . 

(t-> Translate Vector 

Syntax = T (NUMBER / nothing) CA (A / iB > CA 

Semantics- This command is identical to jv in terms of actions 
J»yi the use' 'to specify which vector and .which end. 
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The ;vector keeps its original length and angle, but is moved to 
a new ipositison on the screen. 

Th?e specified end is moved to the position of the biug uhen the 
CAS is hit- 

fvv) -Vertical 

Syntax: V (NUMBER V nothing) CA (A / <BJ CA 

Semantics: T he spe ci f i ed end is moved when the CA is hit so 
thrat tihe y'citor is vertical.. 

ihd Hori frontal i 

Syntax: H (DUMBER / nothing) CA (A J B* CA 

Semantics" The specified end is moved wiften the CA is hit so 
thiat the vector is horizontal. 

Isi Grid 

Syntax: G CA' 

Semantics: The grid provides the user a means to draw "pretty 
» i ctur es". 

Alsl positions arc rounded off to the points on the grid. 

IWe grid also places lines going through grid points such fhat 
thtey can b> soutput, en the printer and still look li-ke straight 
1 i.nes . 

TWe grid is either^ on or off; after typing "g" to g«t "grid- in 
thte romirard .feedback linet a CA causes the grid to change 
it: ate. 

Spaci-ng 

Is'f ) Spsciig. Of f 

Syn tax" S F CA 

l Semantics.: This will set a flag that goes along with the 
picture t e 1 ling the display creation routines not to spsce 
the statements to leave room for this picture- 

Cs n) Spac irvg.- On 

Syntax: S N CA 5 
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Semantics*- This is the rcompl eraen tary command to -spacing ^ff. 
Si nice trie: flag 'is set for spacing on as the defaualt option* 
this command is necessary only to change the f l^g back. 



t&» Abort 

S/ntaxs A CAl 

Semantics: Everything that has been do.rae«< in the current 
instaoce of «the vector package is t hr owm away, the command 
"Vector Parloage" is aborted, and it is as if the command had 
noit be en gLv en. 

(if 3 !F' inished 

Sy'ntax- F CAi 

Semantics: This command returns control from the vector package 
toe MS prober. 
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(trailsS IKe Tr»ail Fe'ature 



The tjrai 1 feature is used to set up statements in such a iway that 
only -a particular -set of statements will be displayed, and in a 

parta.cul'ar order. . 

To understand this feature, it is necessary to know rough!/ what the 
content .analyzeris about; see the document an the content analyzer. 

The troiil f eatur> liaorks as follows: some pattern is set *up as a 
"trail marker' fori a particular set of statements. This pattern as 
to be compiled uit. h the Execute Content Analyzer command I see ec». 

The tr^ii marcer is used to mark "turning points" from the normal 
sequence of staitcrmcnts. Each time the marker appears ana 
statement, it i s followed by a statement name in parentheses. 
This tecrabination of marker and name is used by tre 
dismay-creation routrir.es as a signpost to the next statement to 
be displayed. Between signposts, statements are displayed in 
norma: I sequence^-- subject to any other VfEWSPECs that may be in 
effzat (see VIE-WSPEC >i. 
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The Viewcha nge System 

DisciMSsi'.ojir i This command has an extensive package of suocomands for 
changing, yanicus parameters applying to the display of various 
entitles on the screen. (The syntax description is given further 
on. ) 



me 



o 



These! entities are the bug (its armed cursor, its active cursor, 
and t he mark it leaves), the command feedback line, the date/ta- 
roister, the echo register, the name register, the Vi£WSP£C 
feedback are^, -the working text area.? and the tab stops. 

The firs;t level of . subco tmnands includes specification of these 
entities plus the subcommands "save" and "restore." 

-5-a*es- is use* «to store alt of the current parameters in a buffer 
wain a number from 3 to 8, and "restore" takes one of these 
buffers and puts the parameters stored in it into effect. 

The s^rotnd level of "subcommands includes the (following: 

"Character," Jh:ic h applies only to the bug entities and is used t 
sp^ritfy the character, to be used for plotting each of them. 

"^Jbr-eviated," uhich applies only to the command feedback line and 
causes it to show only the first letter of each word that it would 
niaraaa^lly ccntaiSn.* 

A s?eicial set applying only to the text areaz 

"C^oJuirns* (number of characters in a full line of text) 

"JJnder-ting" tnumber of spaces to indent for each level) 

•LUnes" tmmber of lines in text area — currently limited to 
20 ) 

"R*ous" (same- as *1 ines" ) 

"Vertical increment" (spacing between lines) 

"Pa-a-meter set.i" uhich applies to all entities except tab stops. 
This subs ubcoara and has a number of subs ubsubc omraands. 

Syntax: ilte syntax! is gilven belo-i in hierarchical form, with the 
input letters at the beginning of each statement. "Parameter Set" is 
given in a separate branch following the hierarchy. 

Execute iVieyic barge!" E V iB/C/D/E/ N/R/S/T/V 
Bug: B 0/ A/H 
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Diisarired Cjt'so rs D C/P 

-, Character*: C (any character) CA 
Parameter Sett P (see below) 

Artmed Cursor^ A C/'P 

. Character: C (any character) CA 
j Pararretjri Sets P (see below) 

Marks H C/P I 

• Character: C (any character) CA 
i ParanetssrJ Sets P (see below) 
Coanmamd F eedbactk Lines C P/ A 

'afratneitcr let: P (see below) 
Ab;bre v iateds- A CA r 

Se*artl=s.= Only: the first letter uf each word in the command 
: feedbacc is displayed. 

Date/ Tin*? Registers D P 

Pairameiter Sets-- P (see below) 
Echa {Register: £ P 

Parameter 5e't=* ? (see below) 
Najae '.Register: N P 

Parameter Se ts- P (see below) 

Restosre: R (digit* 1-8) CA 

Semantics: Viewchange conditions previously saved .^^r the 
di.git typed are placed in effect. 

Save:: S (.digits 1-8) CA 

Se mant ics= I he current Viewchange conditions sre saved under 
the digit typed and may be placed in effect later with 
"Rtestore." 

Tabs: (tab chsrlacter) i$(number CA) CA 
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Semantics: Each number typed (followed toy a -C*> sets the 
ponsition of .the next tab stop on: the display, relative to the 
Previous one (the first one is relative to the margin). An 
additional £A {terminates the command. 

Te«t iArea= T C/Jl/t/P/'R/v 

Co!lumnsi € 1 number ) CA 

Semantics* In effect, this sets the .number of character 
positions, from the left-hand margin to the right- hand 
raar.gin. The left-hand margin is fiated. 

Inidcntiirgs I (number) CA 

Semantics.: The number typed sets the number of spaces to 
-: indent for each level in the statement structure. 

Litnes- 1 ltu<mb<er) CA 

Semantics* This sets the number of lines ayailaale for the 
text anaU It is limited to 2 0. 

Parameter Sett P (see beiou) 

fU> ms- R (mra-ber) CA 

. SeiEanti^sit This sets the number of lines available for the 
text erea. - It is limited to 20. 

Ve^rtical Increment- V (number) CA 

Semantics^ This sets the distance between lines in the text 
are a . 

VliWSPiC Area: tf t 

Parameter Se t- P (see below) 

Syntax Under "Parameter Set" 

Paramieter. Set: p i87D/ F JHf I /P/ S 

Bo ldface Ora/Df f : B S(N0T CA) CA 

Semantics-: Any -character except CA changes "on" to "off" or 
, vice vers'a.. 

Display On/Off : D $(N0T CA ) CA 

1 Semantics*: Any character except CA changes "on" to "off" or 
i v ic e ve~sra. 
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Flicker On/0tff = F SfNOT CA) CA 

Semantics*: Any character except- CA changes "on" to "off" or 
i »ice v/c~s:a-i 

Horizontal Increment: H (number) CA 

Semant ics<= This sets the horizontal distance between 

< charact>ns- 

It.alics On/O'ff : I -$<NOT CA > CA 

Semantics^ Any xharacter except CA changes *on" to "off" or 
: vice ve~s«a. 

3 otsitisDn: » {{bug selection of point on screen} CA 

Setusrticsr This sets the position of the first character of 
the entity,: unless the entity is "taact area." In this case . 
Lhet horLz.ontal icemponent is ignored and the vertical 
position <of the first Line is set. 

Si zez S {dig it C-3 J CA 

Semantics;: This sets the character size for the entity= is 
smallest.* I is normal, and 3 is largest. 
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Def In it i>orss> 

(bra-nck). A spec!' !•;><* statement, plus all of its substructure i- e. 

all of. its subststiements. plus all of their substa tements*, etc. 

(bug9 THe mark oi «the screen which is moved by. the raouse -and whicih is 
used #on selecting, {pointing to) entities on the display. 

U*w»n Jthe bug is "active," i.e. when a selection can be made, it 
appears as an up-arrow; uhen it is inactive it appears as a pl.urs 
sigi.i 

(character) Any letter, -digi t. p unct uat i on rnisrk. space, -tab, or 
carriage; returns an indivisible entity 

(chorriJ "A corabinatlion of keys on the keyset Jsee keyset). . 

Far. a table siom irsg the meanings of, the chords, see keytable- 

(file) A cotrplet-* {tree structure of statements* with a single root 
(the origin). 

<filenam!e) The mraie 'of a file. It appears: as the first ward in the 
origin- 

(GCHAR) = Any spacer tab, or carriage return 

Cgroiip) A subset of -a plex, consisting of all branches from one 
specified branch t o another, inclusive- 

(head) The first statement in a subiist- 

Ttee head is saccif ied by specifying any statement in the sublist- 

(invisib le) Any e on. secu ti ve string of gap characters, bounded by 
<but jnota including) printing characters or the end of a statements 
see fsrin.it ing cna-aitcr, -gap character,: statement 

• Speci fied by selecting any character in the string. 

(keyset)s The device at the left-hand side of the console.! When a 
conbinat ion of keys (a chord) is depressed on the keyset, the effect 
is t*ie same as striking a key on the keyboard. 

Fcsr an explanation of the keyset, see keysetex. 
(keyword!) A content indicator for reference retrieval Isee keyaords). 

(label) A string of text placed in a drawing by means of a command in 
the ^Bettor package!. .See vectors. 
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(LEVADJH Tihe spcz i<f icat ion of level when a statement, branch, plea:* 
or groupi is newl/ .treated or moved. 

lUz system will- offer a new number of the same level as the 
precesding nuiJDe<r; this can be changed to a ihigher level- by 
eaterUjig a "u" f or "4JP" or to a lower level: by entering a "D" for 

(AeveiJ ilJ-e "rank" of a statement (see statement) in the foierarchs' of 
the file (see files) - 

T*a» level is equal to the number of fields of letters or digits in 
tJse statement number; thus Statement 3 is a first-level statement. 
Strftetmcnt 4ai3g3 is a fifth-level statement, etc- Level is of 
greats importance in understanding the hierarchical structure of an 
NiJS f iie. 

(raou-se} iTre device* at the right-hand side of the keyboard- When it 
is rolled around on the tablet op* it causes the bug to move 
correspondingly- For an explanation of tne three buttons on top of 
t*>e Bous-e, see mou-sebut. 

(name* If the f i~s-t word: of a statement is ealosed in par. en theses, 
it is th--e n.3 me of the statement- 

The c oilman d Jjm-p to Name (see jn 3 can then be used to place tfee 
si-atetmcnt at tsh«» top of the display. This is done by entering the 
naae from the k ey boar d or keyset, or by finding an occurrence of 
the naue as t»xft on the display and pointing to it witih the bug. 

(or i-gif»)« The first statement in a file; it contains inf ontnation about 
the fllei, plus any. other text the user inserts. It has a level of 0, 
and heuoe no statement number. 

(pattern?) A striig. of text in a statement which may Be compiled via 
the command Execjt'e Content Analyser (see ecJ- When corapi led, it 
produces a program! that is used :by the content-analyzer feature (see 
analyser 1 ) or by tfce rtrai 1 feature (see trails*. 

(PCHAR) - Any letter, digit, or punctuation nusrk 

CplejcS Another rairJa for a substr uct xr e» used an coaisand 
speci/ic.ati ons. 

(pointer ) A string, of up to three characters aahich is attached to 
some character in the text with the Pointer Fix coansand {see pf >■- 

(preoecetssor i The statement preceding a specified statement in a 
sublist.t 

(source); The statement of which a specified statement is a 
substatei me nt . 
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(staterae:nt» The ba.si c structural unit of a file of text atn NLS- 
Formally!, it is a (string of text and/or pieties (see vectors) *iha_ch 
is boindced at t h> beginning by the end of the previous statement -or 
the beginning of the file, and bounded at the end by the beginning of 
another 'statement $or the end of the file. 

St~teun«nts ar» (arranged in a tree structure or hierarchy and ar.e_ 
assigned "statement numbers" which indicate, their positions tn the 
structure. EacJh statement has a number, made up of ail ternaiing 
fields of digits and letters; the number of, fields indicates tine 
"Itei&l" of th» istatement (see level )- 

A statement is specified by selecting any character in the string. 

(subiiiti) The set iof :J all: subs tat ements of a specified statement Cmot 
including th e suds* at ements of t he subst at emen ts> - 

(subset ement) A statement "X" is called a substa tetF,ent_or another 
stat^-sent "Y" if it ds deeper in the structure than "Y. if it 
foilo-w; ("1." and if there is no intervening higher-crder statement. 
• r zs called the source of "X.** The statement number of "X" ui 11 be 
the s«*ei as that of "Y" except that it will have one more field at 
the end.. The valje* of this field gives its ordinal position in a 
"sublist*" of the s ubstat ements of "Y." 

A sabsta tenant sis. specified by specifying the source statement. 

( substructure) The set of all substa tement s o-f a specified statement, 
plus all. their sjb^st atem ents , etc. until no more are found. The set 
of all branches ie.f ined by statements in the sublist of -a Kjiven 
stateaen t- 

(successor} The statement following a specified statement in a 
sublist. i 

(taiiii The last statement in a sublist. 

Tiie tail is spe ci f i ed by specifying any statement in the sublist. 

(text) Any sLrhg. of characters uithin a statement, bounded by (and 
including) tuo spe ci f i ed characters: see character, statement 

(trait) A set of statements in a file, which can be displ-ayed 
sequentially by jsing the trail feature. For -a discussion of this, 
see tarails- 

(yector); A hire in a picture- See vectors. 

(visible.) Any. consecutive string of printing characters, -bounded by 
(but not, including) gap characters or the end of a statement: see 
printing* characters, gap character, statement 
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Specified by jeiccting any character in tine string- If >a single 
g *P c har act cr between two visibies is selected, then both visables 
ara> s peci f ied. . 

(wondJ Any oorae^u.tive string of. letters and/or digits, -bounded b^ 
{but- .not* including) any .other types of characters or the &n6 of & . 

st ataaent: s ee staste ment 

Speci«fied by selecting any character in tfoe string- If a singles 
g<*P character between two words is selected, then both words *r.e 
specified - 
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Odds amd Ensds 

(cente~dioti The centerdot character may be used in any LIT input to 
end «s statement an!d start a new statement- LEJ/ADJ is per.mi.tted. 

(poinierisl Use o' ■? ousters 

Point>ers make it possible to select entities that are not on Lhe 
display- . The entity must have a pointer fixed on it iise e pf >• for 
thas ito be doie. To rselect the entity* hold down the iright-hand 
buitom on the .mouse uhile entering the name.: of the pointer frcrn 
tfie k eyboard or^ keyset, and then release tihe button-.. This is 
e*a=ttly equivalent to making a direct bug selection of <the 
ch^raicter that has the pointer on it. 

Cbraancho nly ) The 8 ranch- Only Feature 

Uttei <jtte branrh«-onl? zfeature is turned on with tte VIEWSPEC g» - 
only "one branch' at a time is displayed (see branch)- In some 
ceases, this gives a less confusing view of the text- It also 
at f ec ts the anoiunt of material output under the Output Device 
coaWLnc; if branchonly is on » output ceases as soon as the branch 
defined hy the statement at the top of the screen has been output. 

{treeJ Tlh* Tree-Display feature 

Br asving tha Vi EH SPEC capital G» it is possible to see the file as 
a trete structure instead of text- The tree structure shows the 
r eiatHcnsihips of "statements in the file- 
All structural commands may be used with the tree display. 
To return to th*s text display, use the VIEiWSPEC capital. H. 
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1 The Information-Retrieval System 

1A The information-retrieval system permits a user to construct a 
specially formatted "catalog" file, containing references to other 
files and capable of being reordered automatically according to some 
chosen set of weighted keywords. When reordered, the file lists 
references in order of relevance according to the choice and 
weighting of keywords. 

IB The Catalog File 

1B1 The catalog file has two functioning sections: a list of file 
references pointing to other files, and a list of relevant 
keywords to be used in retrieving file references. 

1B1A Other material may also be included in the file without 
any effect on the functioning of the retrieval system. For 
example, since the keyword section is to be studied directly by 
the user, it may be desirable to group the keyword entries into 
categories and separate them with headings and subheadings. 

1B2 File-Reference Section 

1B2A Each file reference is a separate statement beginning 
with a serial number in parentheses, followed by a link 
pointing to the referenced file. This is followed by a list of 
keywords relating to the file, followed by comments on the 
file. 

1B2A1 Only the first item is actually essential to the 
working of the system, and it need not actually be a serial 
number;' any string of letters and/or digits enclosed in 
parentheses (i.e. a "statement name" as recognized by NLS) 
will suffice, as long as it is unique to the particular 
reference. 

1B2A2 The use of serial numbers as ."names" in 
file-reference statements, and the inclusion of the other 
items, are matters of convenience to the user. 

1B3 Keyword Section 

1B3A Each kevword must be a single word— i.e. it must 
contain no nonprinting characters. Apart from this, it may be 
any arbitrary string of characters. It is convenient to use 
short strings of three or four letters standing for longer 
words or phrases. 



1B3B 



Each entry in the keyword section is a separate statement 
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with the following format: first the keyword itself, in 
parentheses, serving as the name of the statement; then the 
word or phrase for which it stands, plus any comments or other 
information that may be desired; and finally a special code 
string (such as an asterisk or a dollar sign followed by a 
space) followed by a list of serial numbers which are the names 
of statements in the file -reference section. Each of these 
serial numbers must be enclosed in parentheses. 

1B4 An example is given at the end of this document. 

1C Keyword Commands 

1C1 This section explains the effects of the keyword commands. 
Full details on the syntax and control-dialogue procedures may be 
found in the NLS User Guide. 

1C2 The keyword commands operate upon the keywords themselves, 
i.e. the names of statements in the keyword section of the 
catalogue. The commands permit the user to select keywords as 
relevant; assign integer weights to them; change weights; display 
a list of keywords that have been selected, with their weights; 
and produce an ordered display of the relevant file references. 

1C3 Keyword Select Command 

1CSA This command is used to select a given keyword as 
relevant. It is automatically assigned a weight of 1. 

1C4 Keyword Weight Command 

1C4A When a keyword is selected under this command, its 
current weight is displayed (if it has not been previously 
selected, its weight is zero) . The user may then type in an 
integer which becomes the new weight. 

1C5 Keyword List Command 

1C5A This command causes display of a list of keywords with 
nonzero weights. 

1C6 Keyword List Weight Command 

1C6A This is the same as the "List" command, except that the 
weights are shown. 

1C7 Keyword Forget Command 

1C7A When a keyword is selected under this command, its weight 
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is reset to zero, just as if it had never been selected. 

1C8 Keyword Forget All Command 

1C8A This command causes all keyword weights to be reset to 
zero. 

1C9 Keyword Execute Command 

1C9A This command executes a program which produces an ordered 
display of statements from the file-reference section of the 
catalogue. 

1C9A1 Each entry for a selected keyword is scanned, and the 
serial numbers which it contains are noted. 

1C9A2 Each of these serial numbers is the name of a 
statement in the file-reference section: each of these 
statements is assigned a "score" equal to the weight of the 
keyword, and this score is accumulated with further 
references from other keywords. 

1C9A3 When all of the selected keywords have been used to 
score the file references, the file-reference statements 
with non-zero scores are displayed in order of decreasing 
score. 

ID Example of Catalog File 

1D1 Examples ~ Keyword Entries 

1D1A (nls) on-line system * (ul) (u2) (u3) (u4) 

1D1.B (ug) user guides * (ul) (u2) (u4) 

1D1C (kse) keyset * (ul) 

1D1D (cdp) control-dialog proc. * (ul) 

1D1E (anz) content analyzer * (u2) 

1D1F (fij) file jumping * (u3) 

1D1G (inf) info, retrieval * (u4) 

1D1H (vs) view control * (ul) (u3) 

1D2 Examples — File-Reference Entries 
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1D2A (ui). (nlist,l:xnhj) nls,ug,vs,kse,cdp; nls user guide 

1D2B (u2) (conan,l:x2bhj) anz,ug,nls; content analyzer user 
guide 

1D2C (u3) (links,l:x2bhj) fij, vs, nls; link jumping and returns 

11)21) (u4) (infor,l:x2bhj) inf,ug,nls; information retrieval 
system 

IE Example of Reordering 

1E1 Suppose that the system is used on the catalogue shown above. 
The user has considerable interest in file jumps, so he gives the 
keyword "fij" a weight of 5. lie is also interested in 
control-dialog procedures, so he gives the keyword "cdp" a weight 
of 3. Finally, he is also interested in user guides, so he gives 
"ug" a weight of 1. 



1E2 When the command Keyword Execute is given, the following 
scoring is done: 

1E2A Hie keyword "fij", with a weight of 5, applies to serial 
number u3; therefore the statement whose name is "u3" is given 
a score of 5. 

1E2B The keyword "cdp", with a weight of 3, applies to serial 
number ul; therefore the statement whose name is "ul" is given 
a score of 3. 

1E2C The keyword "ug", with a weight of 1, applies to serial 
numbers ul, u2, and u4; therefore the statements whose names 
are "ul", "u2", and "u4" are given scores of 1 each. In the 
case of "ul", this is added to the previous score of 3. 

1E3 The final scores are 4 for "ul", 1 for "u2", 5 for "u3", and 
1 for "u4". They are then displayed as follows: 

(u3) (links, l:x2bhj) fij,vs,nls; link jumping and returns 

(ul) (nlist,l:xnhj) nls,ug,vs,kse,cdp; nls user guide 

(u2) (conan,l:x2bhj) anz,ug,nls; content analyzer user guide 

(u4) (infor,l:x2bhj) inf,ug,nls; information retrieval system 

1E3A The user may then access the referenced files by using 
the Jump to Link command with the links given in the 
references. 
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1 The Content Analyzer ! 

1A The content analyzer feature of NLS* permits the user to specify 
( tn a special language) a pattern o con ^^rne^analy- is 

£K on^a VlSEC £r ;:r t reter) r onl? statements which meet the 
content specification will appear on the display. 

1A1 The pattern specified may be a simple one -- e.g. it may 

p cify a spring of "characters that ^^^1^71 It may 
^ ^ u~ j; c «i ovoH* or it may be complex -- e.g. j-v- «»«•/ 

specified string. ! 

complex cases. j 

IB Pattern-Specification Language j 

1B1 The Process of Searching a Statement j 

proceed backwards. 

1R1B The analyzer uses a pointer to keep track of the search. 

moved first. 

1B1C At any given moment in the "^.gJ^Ji * e ^^ 
is searching for one of four types of content entity. 

1B1C1 A literal string of characters, such as "abed" or 
"13-x" or "ed Mat" or "memory." 

1B1C2 A string of character-class! variables; ***•«* 
exSainedln aetail further on. A string of character-class 
tables might specify "three digits one after another 
or "two letters, followed by any number of spaces, toiiow 
by three to five letters or digits. 

1B1C3 The date associated with the statement. This is not 
displayed, but every statement bears the date on which it 
was created or most recently modified. 



1B1C4 The initials associated with the statement. This is 
not displayed, but every statement bears the initials of the 
user by whom it was created or most recently modified. 

IBID All of the more complex analysis j is achieved by moving 
the pointer according to the logic or m 1 
specification. 

1B1IU For example, if the analyzer is to start at a given 
ioint and find either String A or String B, it first looks 
for strin, A and then, if String A is not found, the pointer 
^returned tlTthe starting point and a search is made for 
String B. ( 

i 

1B2 Basic Elements 

1B2A Every pattern ends with a semicolon. 

1B2B Every pattern is made up of one or more of the basic 
entities listed above, combined by operators. 

iH2r If the pattern (or some part of it) is to be found 
anywhere afte/ the point in the statement where the search 
begins! it is enclosed in square brackets; otherwise it must be 
the first thing found. 

1B21) A string of characters specified as content is enclosed 
in quotation marks. For convenience, if the string consists of 
only one character it may be preceded by an apostrophe and the 
quotation marks omitted. 

1B2M Examples 

1B2D1A ["memory"]; This pattern will cause display of 
only those statements containing the word "memory" at any 
point . 

1B2D1B "inside"; This pattern will cause only 
statements beginning with the word "inside" to be 
displayed. 

1B2D1C ['3]; This pattern will cause display of only 
those statements containing the character "3" at any 
point. 

1B2E Patterns like those shown in the examples above may be 
strung together; the significance of this is that one item is 
to be found after the one specified ahead of it. 

1B2E1 Examples 

1B2E1A ["abc""def"j ; This pattern specifies that .the 
string "abc" immediately followed by the string def 



must appear somewhere in each statement to be displayed. 
The pattern ["abcdef"] ; is exactly equivalent. 

1B2K1B ["abc"] ["def"] ; This pattern specifies that the 
<;rrinp "abc" is to be found anywhere in the statement, 
5 anywhere after the "c" the string "def is to be 
found. 

1B3 Character-Class Variables 

1B3A The character- class variables are £s follows: 
1B3A1 L means any letter | 

1B3A2 I) means any digit v 

! 

1B3A3 LI) means any letter or digit j 

1B3A4 PT means any printing character (any character except 
space, tab, and carriage return) 

1B3A5 SP means a space 

1B3A6 TAB means a tab 

1B3A7 CR means a carriage return 

1B3A8 NP means any nonprinting character (space, tab, or 
carriage return) 

1B3A9 CH means any character at all. 
1B3B Examples 

1R-4K1 r» ILL'=I) , *1: This pattern will cause display of 
only thole statements containing (anywhere) the following 
content- a period immediately followed by three letters 
SXieiy followed by an equals sign, immediately followed 
by a digit, immediately followed by a semicolon. 

1B3B2 "abcd"SPL D; This will cause display of only those 
statements beginning with the following content: the string 
abed immediately followed by a space, immediately followed 
by any letter, immediately followed by any digit. 

1B3B2A Note that a space is necessary between the L and 
the D because of a possible ambiguity: The pattern 
»abcd"SPLD; would mean "the string abed immediately 
followed by a space, immediately followed by any letter 
or digit," because LD means any letter or digit. 

1B4 The Dollar Sign (ArMtraty*Number Construct) 



IMA The arbitrary-number construct, in its most general form, 
is m$n. The meaning is "any number from m to n of occurrences 
of the following entity." j ; 

1B4B When the analyzer has found n occurrences of the 
specified entity, it also looks ahead to see if there is 
anotner occurrence. If there is, the test is considered to 
have failed. In other words, the limits m and n are absolute. 

1B4B1 Example 

1B4B1A The pattern 5$11LD; specifies th=t each staement 
to be displayed must begin with five to eleven letters 
and/or digits. 

1B4B1A1 A statement beginning with twelve or more 
letters and/or digits would be rejected by this 
pattern. 

1B4C The m or the n, or both, may be omitted; their assumed 
values in this case are m=0, n=1000. For all practical 
Srpose S ; thS. the default value of n is "any arbitrary 
number," since it is very unlikely that any entity will occur 
1000 times consecutively. 

1B4C1 Examples 

1B4C1A The pattern [7$I)1$12L$5NP] ; specifies that each 
statement to be displayed must contain the following: 
seven or more digits immediately followed by one to 
twelve letters, immediately followed by zero to five 
nonprinting characters. 

1B4C1B The pattern 2$"abc"; specifies that each 
statement to be displayed must begirt with two or more 
occurrences of the string abc, one after another. 

1B5 Grouping by Parentheses 

XBSA Parentheses may be used as they are in algebra to group 
elements. The specifications found within the parentheses are 
then treated as a single entity for logical purposes. 

1B5A1 Example 

1B5A1A [3$4(DSPL)1$2NP]; This pattern specifies that 
each statement to be displayed must contain the 
following: three or four ocurrences of the string (digit 
space letter), immediately followed by one or two 
nonprinting characters. 

1B5A1A1 If the parentheses were not used, the 3$4 
construct would apply only to the I). 



1BSH The square brackets have same grouping the effect as 
parentheses; however, they are not interchangeable with 
parentheses because they also mean that the enclosed pattern 
may be found anywhere after the starting point. 

1B6 Operators 

1B6A The operators used for combining entities are as follows, 
in order of decreasing precedence: 

1B6A1 - (minus sign) : This indicates negation. Thus -LD 
means a character which is not a letter or a digit. 

1B6A1A Example: [»abc"-SP] ; This pattern specifies 
that each statement to be displayed must contain the 
string abc immediately followed by some character which 
is not a space. 

1B6A2 (space) : This indicates concatenation. Thus 
"abc""xyz"; specifies that the string abc must occur and 
must be immediately followed by the string xyz. 

1B6A2A The space may be omitted unless it is necessary 
to prevent ambiguity. 

1B6A3 / (slash): This indicates alternation. Thus SP/TAB 
means a character that may be either a space or a tab. 

1B6A3A Example: 1$SP/2$3PT; This pattern specifies 
that each statement to be displayed must begin with 
either one or more spaces, or two or three printing 
characters. 

1B6A4 NOT: This indicates negation, and is the same as the 
minus sign except for lower precedence. 

1B6A5 AND: This is Logical intersection. 

1B6A5A The action of the AND is to return the pointer to 
the beginning of the search that has just been completed. 

1B6A5A1 Example: The pattern ["abc" ] AND ["xyz"] ; 
causes each statement to be searched first (from the 
beginning) for the string abc; then, if it is found, 
the statement is searched again from the beginning for 
the string xyz. Each statement displayed will contain 
both strings, but the order in which they occur will 
be irrelevant. 

1B6A5A1A Note that this is different frow the 
pattern ["abc"j ["xyz") ; if the AND is not used, 
the second search is not made from the beginning 
but from the point just after the end of the first 



search. Each statement displayed will then contain 

both strings, but the string xyz must be somewhere 

after the string abc. When the AND is used, this 
restriction will not apply. 

1B6A5A1B Note also that the pattern 
["abc"AND"xyz"] ; is meaningless: it specifies a 
string that is both "abc" and "xyz". 

1B6A6 OR: This is the same as the slash sign, except for 
the lower precedence. 

1B6B Note on Precedence of Operators: As used here, "high 
precedence" means that when the pattern is parsed, the 
higher-precedence operators are used first in grouping the 
elements of the pattern. Thus a high-precedence operator has 
low "binding power." 

1B6B1 Example: Consider the pattern a AND b OR c/-d AND 
NOT e f; where a, b, c, d, e, and f are pattern elements 
such as quoted strings or character-Class variables. 

1B6B2 This is grouped as follows: 

1B6B2A The minus sign has the \ highest precedence, so 
that we have a AND b OR c/(-d) AND NOT e f; 

1B6B2B Next is concatenation, so we have a AND b OR 
c/(-d) AND NOT (e f ) ; 

1B6B2C Next is the slash, so we have a AND b OR (c/(-d)) 
AND NOT (e f) ; 

1B6B2D Next the NOT, giving a AND b OR (c/(-d)) AND (NOT 
(e f)); 

1B6B2E Finally, the AND gives (a AND b) OR ((c/(-d)) AND 
(NOT (e f)));. 

1B7 Dates and Initials 

1B7A The (invisible) dates and initials attached to each 
statement may be tested with the constructs .SINCE, .BEFORE, 
.INITIALS*, and .INITIALS*. (The symbol # is used to mean "not 
equal".) 

1B7B The .INITIALS construct requires the following format: 

1B7B1 .INITIALS=ABC where the string abc is a user»s 
initials (three initials must be given). 

1B7C The .SINCE and .BEFORE constructs require the following 
format: 



1B7C1 .SINCE (68/10/12 13:14) where 68 is the year, 10 is 
the month, 12 is the day, 13 is the hour, and 14 is the 
minute. The time may be eliminated by using 0:0. 

1B7C2 Examples 

1B7C2A .BEFORE (67/3/22 15:15) AND .SINCE (67/1/12 
12:00); This pattern will cause display of only those 
statements bearing dates between noon of 12 January 1967 
and 3:15 PM of 22 March 1967. 

1B7C2B .SINCE (68/10/10 0:0) AND . INITIALS* DGC; This 
pattern will cause display of only those statements 
bearing dates later than 10 October 1968 and not bearing 
the initials DGC. 

1B8 The WITHIN Construct ! 

1B8A The WITHIN construct has the following format: 
WITHIN n FIND expl SKIP exp2 

where expl and ex P 2 are patterns and n is an integer. The 
search starts at the current position and the content 
specified by ex P 2 is skipped up to n times in a search for the 
contnt specified by ex??. If any content other than what is 
specified by ex P 2 or expl is found, the search fails. 

1B8A1 Example 

1B8A1A ["write"] WITHIN 3 FIND " file" SKIP 1$NP1$PT; 
Ills pattern specifies the word "write" followed by the 
word "file", with up to three words intervening. 

1B8A1A1 The search works as follows: after the word 
"write" is found, the search pointer indicates the 
space following the word. The ex P 2 pattern calls for 
one or more nonprinting characters followed by one or 
more printing characters; thus the space and the next 
Cora are skipped and the pointer again indicates a 
space? This skipping process is repeated up to three 
times, until the word "file" is found. 

1B9 Special Control of Search 

position of the St.. „ ,.,,.„ 

direction of search can be controlled, m order to 



1B9A The position of the search pointer can be stored and set 
«id the direction of search can be controlled, m order to 
achieve complex effects. These effects also involve the use of 



the IF construct (described further on), and the Possibilities 
have been explored only superficially at present. It should be 
possible to create pattern expressions of great complexity 



have not been worked out. , 

of nine buffers, Pi ... rv*. j»« * 
where n is some digit from l to j. 

1B9A1A The stored value in the buffer can then be 
Tcremenied by writing <-Pn The reason for doing this is 
that when the analyzer has found some entity, tn e poin ter 

then, it is necessary to write tPn<-Pn. 

1B9A2 The search pointer can then be set to the value in a 

buffer by writing Pn. T 

1B9A3 The search pointer can also be set to the beginning 

-S end of a statement by writing SF(Pn) for the beginning 

and SE(Pn) for the end. 

1B9A3A Note that SF and SE are potions which require a 
h,,ffer value as argument buffer values «tre i 
reinitialized after a statement has been scanned but 
continS to indicate the same W« Jn^ ««««t 
thev were originally set to. Thus it is possible for a 
search to cover more than one statement. 

1B9A4 The normal direction of scanning may be reversed by 
writing a SSs-than sign «) and returned to the forward 
direction by writing a greater-than sign L>J . 

1B9A4A The left-arrow («0 used for decrementing a buffer 
value will increment it instead If the current scan 
direction is backward. Thus the effect will £Wj£ 
the same - the buffer value will indicate the character 
just scanned. 

1B9A4A1 Example 

1B9A4A1A tPl SE(Pl) < $NP -•.; This pattern 
causes statements to be searched backwards from the 
end. Only statements whose last printing character 
is not a period will be displayed. 

1B9A4A1A1 The construct "tPl" at the beginning 
of the pattern causes the current pointer 
position (which indicates the beginning of the 
statement) to be stored. This is ■jy***^ 
mirnose of having an argument for the SUPiJ 

Set which* causes the pointer to be 
positioned to the end of the statement. The 
less-ihan sign then causes the scan to proceed 
DackwaS; anther, of nonprinting characters 



will be permitted, and then a character which is 
not a period is specified. 

1B10 The IF Construct 

1B10A The IF construct has the following format: 

(IF re 1 at THEN expl ELSE exp2) 

where "relat" is a relationship between two buffer values and 
expl and exp2 are pattern expressions. 

1B10B The possible relationships are as follows: 

1B10B1 .EQ (equals) ; 

1B10B2 ,NE (not equal to) 

1B10B3 .LT (less than) 

1B10B4 .LE (less than or equal to) 

IB10B5 .GT (greater than) 

1B10B6 .GE (greater than or equal to). 

1B10C If the specified relationship is true, expl is used for 
a test; if it is not true, exp2 is used. 

1B10C1 Example 

1B10C1A tPl SE(P1) < ([»e] tP2*-P2 AND [«t] tP3«-P3) (IF 
P2 ,LT P3 THEN SF(P1) > $SP "The" ELSE SF(P1) > [" if 
"]); This pattern imposes the following condition on 
statements to be displayed: If the last "e" precedes the 
last "t", then the first word in the statement must be 
"The". Otherwise, the statement must contain the word 
"if", enclosed by spaces. The proof is left to the 
reader. 

1B11 The .EMPTY Construct 

> ' ■ i 

1B11A Whenever the analyzer makes a test, a flag is set true 
or false. After a statement has been tested by the complte 
pattern, it is displayed if the flag is |true and omitted if the 
flag is false. 

1B11B The construct .EMPTY simply sets the flag true. 
Conversely, the construct NOT .EMPTY (o* -.EMPTY) sets the flag 
false. ■.' | . . 

1B11C This is useful in the IF construct, where one may simply 
wish to test the relationship without imposing further tests. 



1B11C1 Example 

£."£*£-£ t^as^t"! K ™< will b o 
displayed, otherwise it will not. 

1B11C1A1 The "tPl" stores the pointer ™J™. $$ 
inicates the beginning o£ the statement. The J>*y*J 
sets the pointer to the end of the statement, and the 
»<" causes a backward scan. An "e» is found and its 
position stored in P2; then a "t" is found and its 
position stored in P3. The IF construct compares the 
values of P2 and P3: if P2 is less than P3 (i.e. .if 
the »e» precedes the »t" in the statement) , the NOT 
.EMPTY" takes effect and the flag i».***a \?^°*l 
statement will not be displayed; if P2 » not less 
than P3, the ".EMPTY" takes effect, the tlag is 
true, and the statement is displayed. 

1C Procedure for Using Content Analyzer 

1C1 A pattern may be written as text anywhere in a file. A file 

:i risf «V srrs^s svsss 

the code created by the previous one is lost. 

1C2 To compile a pattern, the command Execute Content Analyzer is 

used. The syntax is 

ec [cl] CA 

where fell means that a character is selected either with the 
m ouse or by means of a pointer call, and CA means that a Command 
Accept key is struck. 

1C2A The character selected must be either the first character 
of the pattern or a nonprinting ■ character preceding the 
pattern, with no printing characters intervening. 

1C2B Note that the last part of a pattern may thus be used as 
a separate pattern, if it is meaningful. 

1C3 The screen will go ^f" 1 ^ 1 ^^^ * ^^successful 
■nattt^m has been compiled, trie message is ^»-^ 
completion"! if the pattern has an error in it which prevents it 
from compiling, the message is "syntax error . 

1C3A Syntax errors are fequently caused by ^advertent 
omission of some character such as potation .art. Another 
common cause for a syntax error or a compiled pattern xnat 
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not work as expected is an error in j the way parts of the 
Tatterf are grouped. In the latter case, the problem may often 
be solved by insertion of parentheses. 

1C4 When the pattern has been compiled, it will not go into 
effect until the view-control parameter "1" is placed in effect. 
mil this has been done, the system will display only statements 
which fit the pattern. 

irs Testing of statements begins with the statement currently 
designated as the display start; other statements are then tested 
in the order in which they would appear "normally," i.e. with the 
analyzer off. Any other view specifi -tions which are xn effect 

T^^^» S2t?^^5S5l statements will 
be tested by the analyzer. 

1C6 Statements are tested until the display screen has been 
filled If no statements are found that fit the pattern the 
screen'goes blank with the message "empty' and remains jo unti 
the analyzer is turned off or until changed view-control 
palters make it possible to find a statement that fits the 

pattern. 

1C7 Whenever the display is recreated, the ^f^ process is 
repeated. Thus if a statement is edited, and the edi ting Ranges 
it so that it no longer fits the pattern, it will disappear from 
the screen. 
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LINK SYNJfiXf AND" LSEFU'L KNOWLEDGE 

Preliminary: Document on Links 

Link syntax: (ussrname. fi lenamc» s ta tementdes: V lEWSPECs) 

T<he uisernaisc is the name of the user under whose name the desired 
file is sttcred on the RAO. 

If* it is omitted* the name of the owner of the currently 
di splayed fi le is assumed. Note that this is not necessarily 
the same name that has been given to the Exec or to NLS when 
enitering. nor the name under which the current file is stored 
ons the RAD. - 

T<he f:ilenane is the name under which the desired file is stored on 
Lhe R AC. 

If- this is omitted* the currently displayed file is assumed. 
NosJt* that in this case a username may not be given. 

Ttie s tatementdes is either a statement name or a statement nuaiber. 
If- bhis is omittedt the origin of the file is assumed. 

Tihe V lEWSPECs are the usual code letters, in a string just as i f 
.t«ey iwere being entered from the keyboard or keyset. 

If- tih i s is omitted, the current VIEWSPECs are assumed. 

The intr^af il e Return Ring 

Wheielvtr .ary jump is made within the file (except by Jump Return 
and J unp Ahead), a neu entry is made in a list called the 
intraif i le ring. 

Eaicr of thase entries gives a display start and a set of 
VI EkSPECs- 

A "po inter" indicates the current view on the list; each time =a 
norsdi 1 jump is executed, the new information is written ahead of 
t'he pio inter and the pointer is moved forward. 

On: a Jump Return or Jump Ahead command, tne pointer is simply 
lodvcd backward or ifcrward and no new entries are made. 

The ring may. hold a maximum of five entries. If a Jump Ahe-ad 
is oad e from the last entry, the pointer is ;mcved to the first 
entry; cany erse ly . if a Jump Return is made from the first 
entry <tre »o inter is moved to the last entry (hence the term 
"r- ing" ) . 

The Interfile Return Stack 



LINK SYJITAX* AND USEFUL KNOWLEDGE 



The intenfilc stack works much like the intrafiie stack, with the 
following exceptions and complications: 

The length of the list is variable, and depends on the ataount 
ofn information in the links used. 

Theilist is not set up as a ring; a Jump to File Ahead from the 
la:st entry or Jump to File Return froia the first will cause an 
ertrcr message and abort the command. 

TheiWCRKINC £OPY file is never entered in the stack: (the 
WOiRKIKG CfPTi is explained below). 

The CHECKPOINT file is never entered in the stack. 

A «ewl entry is made on the stack whenever a file is loaded with 

the UBd ifile cowand (not Load Checkpoint), or whenever any 
in.teri.fi le jump is executed with Jump to Link or Jump to File Link. 

A ^pcirter indicates the current viewi just as in the intrafiie 

rinc. 

Toe command Jjm p to File Working Copy causes the WORKING COPY file 
to be opened and displayed; the pointer is not moved, but 
continues to indicate, the last file viewed in the stack. The 
cozRiaa-nc Jump to File Current causes this file to be opened and 
displ aycti. 

Opening iard iDisplaying Files -- The WORKING COPY File 

When a if ile is loaded or jumped to, it is "opened" and displayed; 
no co:py is created, rather the file itself is viewed directly on 
tne R A.D. • However, if any changes are made in the file it becomes 
iiEpos^sible to continue this. At some point the system will create 
a iJORiKJNG COPY, copy the displayed file to it, close the displayed 
file, sne display the WORKING COPY instead, with the changes. 

The WORKING COPY i s no t always made as soon as changes are 
specified; however, when it is created a message to that effect 
apiipcars on the screen. 

Crieotion of a WORKING COPY can always be forced by specifying 
the ccmnand Output File and then hitting CD irstead of CA. 

Creation of a WORKING COPY can always be avoided by doing 
nothing except intraf ile jumps and VIEWSPECs. 

Uhen *ycu create- a new file, working in NLS. the file is the 
WJjRKI NG COPY (no message is displayed in this case to show 
crest ion of WORKING COPY). 

Whier you ojtput such a file with Output File, it is NOT entered 
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in the» interfile stack. Tp enter it on the stack, you must 

load it or jump to it. 

You cen, however, display ;it tilth 'Jump to Working Copy, unless 
a flncu WORKING COPY is created from some other file. 

Special Points and Helpful Hints 

It is posisible to move the pointer without displaying a new file. 
I*us .Willi happen if you specify a Jump to file Ahead or Return and 
tHen .abort it with CO. The results can be confusing Out since the 
stacta is never -very Long you can generally find your way back to 
where; you wanted to go fairly quickly. 



